Node / meshtastic / Meshtastic-Android / files / feature / docs / src / commonMain / kotlin / org / meshtastic / feature / docs / ui / ComposeResourceImageTransformer.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.docs.ui

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.collectAsState

Tff7b72import T7ee787androidx.compose.runtime.getValue

Tff7b72import T7ee787androidx.compose.runtime.mutableStateOf

Tff7b72import T7ee787androidx.compose.runtime.remember

Tff7b72import T7ee787androidx.compose.runtime.setValue

Tff7b72import T7ee787androidx.compose.ui.geometry.Size

Tff7b72import T7ee787androidx.compose.ui.graphics.painter.Painter

Tff7b72import T7ee787coil3.compose.AsyncImagePainter

Tff7b72import T7ee787coil3.compose.LocalPlatformContext

Tff7b72import T7ee787coil3.compose.rememberAsyncImagePainter

Tff7b72import T7ee787coil3.request.ImageRequest

Tff7b72import T7ee787com.mikepenz.markdown.model.ImageData

Tff7b72import T7ee787com.mikepenz.markdown.model.ImageTransformer

Tff7b72import T7ee787meshtasticandroid.feature.docs.generated.resources.Res

Tff7b72import T7ee787org.jetbrains.compose.resources.MissingResourceException

Tff7b72private Tff7b72const Tff7b72val Te6edf3ASSETS_SEGMENT Tff7b72= Ta5d6ff"Ta5d6ffassets/Ta5d6ff"

T8b949e/**

* Maps a markdown image link to its bundled compose resource path, or `null` for external URLs.

*

* Authored pages use paths relative to the Jekyll source layout (`../../assets/screenshots/foo.png` from

* `docs/en/user/page.md`), while the compose resource tree drops the `en/` level (`files/docs/user/page.md` with

* screenshots at `files/docs/assets/screenshots/`). Relative prefixes therefore cannot be resolved literally; instead,

* anything from the `assets/` segment onward is anchored at `files/docs/`, which matches where

* `syncDocsToComposeResources` places the bundled screenshots.

*/

Tff7b72internal Tff7b72fun Td2a8ffresolveDocImageResourcePathTb4b4b4(Te6edf3linkTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657String? Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3linkTb4b4b4.Te6edf3startsWithTb4b4b4(Ta5d6ff"Ta5d6ffhttp://Ta5d6ff"Tb4b4b4) Tff7b72|Tff7b72| Te6edf3linkTb4b4b4.Te6edf3startsWithTb4b4b4(Ta5d6ff"Ta5d6ffhttps://Ta5d6ff"Tb4b4b4)Tb4b4b4) Tff7b72return Tff7b72null

Tff7b72val Te6edf3assetsIndex Tff7b72= Te6edf3linkTb4b4b4.Te6edf3indexOfTb4b4b4(Te6edf3ASSETS_SEGMENTTb4b4b4)

Tff7b72val Te6edf3isSegmentStart Tff7b72= Te6edf3assetsIndex Tff7b72=Tff7b72= T79c0ff0 Tff7b72|Tff7b72| Tb4b4b4(Te6edf3assetsIndex Tff7b72> T79c0ff0 Tff7b72&Tff7b72& Te6edf3linkTff7b72[Te6edf3assetsIndex Tff7b72- T79c0ff1Tff7b72] Tff7b72=Tff7b72= Ta5d6ff'/'Tb4b4b4)

Tff7b72return Tff7b72if Tb4b4b4(Te6edf3assetsIndex Tff7b72>Tff7b72= T79c0ff0 Tff7b72&Tff7b72& Te6edf3isSegmentStartTb4b4b4) Tb4b4b4{

Ta5d6ff"Ta5d6fffiles/docs/Tffd700${Te6edf3linkTb4b4b4.Te6edf3substringTb4b4b4(Te6edf3assetsIndexTb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4} Tff7b72else Tb4b4b4{

Ta5d6ff"Ta5d6fffiles/docs/Tffd700${Te6edf3linkTb4b4b4.Te6edf3removePrefixTb4b4b4(Ta5d6ff"Tff7b72/Ta5d6ff"Tb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4}

Tb4b4b4}

T8b949e/**

* Resolves local markdown image references (e.g. `../../assets/screenshots/foo.png`) to bundled Compose resources via

* [Res.getUri] and loads them asynchronously using Coil 3's [rememberAsyncImagePainter].

*

* External URLs (`http://` / `https://`) return `null` so the default renderer behaviour applies (or they are simply

* skipped). Missing resources are silently skipped (returns `null`) to avoid crashing composition when screenshots have

* not yet been generated or synced.

*

* FR-038: Screenshots synced by `syncDocsToComposeResources` land under

* `composeResources/files/docs/assets/screenshots/`; [resolveDocImageResourcePath] maps the authored markdown paths

* onto that location.

*/

Tff7b72class T56d364ComposeResourceImageTransformer Tb4b4b4: Te6edf3ImageTransformer Tb4b4b4{

Tf0883e@Composable

Tff7b72override Tff7b72fun Td2a8fftransformTb4b4b4(Te6edf3linkTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3ImageData? Tb4b4b4{

Tff7b72val Te6edf3resourcePath Tff7b72= Te6edf3resolveDocImageResourcePathTb4b4b4(Te6edf3linkTb4b4b4) Tff7b72?: Tff7b72return Tff7b72null

Tff7b72val Te6edf3uri Tff7b72=

Tff7b72try Tb4b4b4{

Te6edf3ResTb4b4b4.Te6edf3getUriTb4b4b4(Te6edf3resourcePathTb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3_Tb4b4b4: Te6edf3MissingResourceExceptionTb4b4b4) Tb4b4b4{

Tff7b72null

Tb4b4b4}

Tff7b72return Te6edf3uriTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3resolvedUri Tff7b72-Tff7b72>

Tff7b72val Te6edf3painter Tff7b72=

Te6edf3rememberAsyncImagePainterTb4b4b4(

Te6edf3model Tff7b72=

Te6edf3ImageRequestTb4b4b4.Te6edf3BuilderTb4b4b4(Te6edf3LocalPlatformContextTb4b4b4.Te6edf3currentTb4b4b4)

Tb4b4b4.Te6edf3dataTb4b4b4(Te6edf3resolvedUriTb4b4b4)

Tb4b4b4.Te6edf3sizeTb4b4b4(Te6edf3coil3Tb4b4b4.Te6edf3sizeTb4b4b4.Te6edf3SizeTb4b4b4.Te6edf3ORIGINALTb4b4b4)

Tb4b4b4.Te6edf3buildTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3ImageDataTb4b4b4(Te6edf3painterTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@Composable

Tff7b72override Tff7b72fun Td2a8ffintrinsicSizeTb4b4b4(Te6edf3painterTb4b4b4: Te6edf3PainterTb4b4b4)Tb4b4b4: Te6edf3Size Tb4b4b4{

Tff7b72var Te6edf3size Tff7b72by Te6edf3rememberTb4b4b4(Te6edf3painterTb4b4b4) Tb4b4b4{ Te6edf3mutableStateOfTb4b4b4(Te6edf3painterTb4b4b4.Te6edf3intrinsicSizeTb4b4b4) Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3painter Tff7b72is Te6edf3AsyncImagePainterTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3painterState Tff7b72= Te6edf3painterTb4b4b4.Te6edf3stateTb4b4b4.Te6edf3collectAsStateTb4b4b4(Tb4b4b4)

Te6edf3painterStateTb4b4b4.Te6edf3valueTb4b4b4.Te6edf3painterTff7b72?.Te6edf3intrinsicSizeTff7b72?.Te6edf3also Tb4b4b4{ Te6edf3size Tff7b72= Tffa657it Tb4b4b4}

Tb4b4b4}

Tff7b72return Te6edf3size

Tb4b4b4}

Tb4b4b4}